home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / graphics / sfwjpg / sfwjpg.readme < prev    next >
Text File  |  1999-06-15  |  7KB  |  160 lines
  1. Short: Seattle FilmWorks (SFW) to JFIF converter (68k+PPC)
  2. Type: gfx/conv
  3. Uploader: Andreas_Kleinert@t-online.de
  4. Author: Everett Lipman, Andreas R. Kleinert (port/adjustments)
  5.  
  6.  This is an Amiga (68k+PPC) port (*) of Everett Lipman's
  7.  GNU tools sfwjpg, pwpjpg and flipjpeg plus the shell script
  8.  pwpext for conversion of SFW JPEG files to normal JFIF files
  9.  (SWF seems to be a somewhat strange non-standard JPEG derivate,
  10.  which isn't very well documented)
  11.  
  12.  Enjoy the Amiga port of the 9/May/99 version. See Everett's
  13.  homepage under http://www.lipman.org/software/sfw/ for the
  14.  complete, original archive (tar archive with precompiled ELF
  15.  versions for Linux and Solaris) or any source updates.
  16.  
  17.  I've also added a copy of the GNU license, which
  18.  was missing (COPYING) - you may as well obtain it
  19.  from the GPL site under http://www.fsf.org/copyleft/gpl.html
  20.  
  21.  This software is based in part on the work of the Independent
  22.  JPEG Group. Not included is the source of libjpeg - so, for
  23.  recompilation you will have to obtain and compile a copy
  24.  yourself, first.
  25.  
  26.  PPC binaries have the ".elf" extension and are useable from Shell
  27.  when being used with ppc.library V46+
  28.  
  29.  Following is an excerpt from the original docs (still 1st draft).
  30.  
  31.  Have fun.
  32.  
  33.  --                           (*) added smakefile, SCOPTIONS
  34.  ARK, 24/May/99                   and an additional header;
  35.                                   for source changes, see
  36.                                   amiga.h and pwpjpg.c
  37.  
  38.  *************************************************************************************
  39.  *************************************************************************************
  40.  
  41.   The programs sfwjpg and pwpjpg convert from Seattle
  42.   FilmWorks's private file formats to JFIF (JPEG File Interchange
  43.   Format).  As far as I am aware, Seattle FilmWorks does not
  44.   make public the specifications of these formats.  The format
  45.   specifications were deduced by examining a number of
  46.   .sfw and .pwp files, and may not be entirely accurate.  In
  47.   particular, some .sfw files which were downloaded from the SFW
  48.   web site were not properly converted to JFIF.  All .pwp files
  49.   which were downloaded from SFW and tried have been converted
  50.   without any problems.
  51.  
  52.   pwpext is a UNIX (Bourne) shell script, and will not work
  53.   unless pwpjpg and flipjpeg are in the search path ($PATH)
  54.   when it is invoked.
  55.  
  56.   flipjpeg is written using the Independent JPEG Group's free
  57.   JPEG software.  It has only been tested under UNIX.  Because
  58.   of some attributes of the JPEG compression scheme, flipjpeg
  59.   will only work on images whose height in pixels is a multiple
  60.   of 8, and sometimes only on those whose height is a multiple
  61.   of 16.  Since SFW scans at 640x480, flipjpeg will work for
  62.   converted SFW images.  See details.txt for more info.
  63.  
  64.  
  65. sfwjpg
  66.  
  67.   sfwjpg will take a single .sfw file and convert it into a
  68.   .jpg (JFIF) file.  The image in the newly created .jpg file
  69.   will then need to be flipped vertically.  sfwjpg takes a
  70.   single argument, the name of the .sfw file to be converted:
  71.  
  72.   sfwjpg mypic.sfw
  73.  
  74.   This will create the file mypic.jpg in the current directory.
  75.   mypic.sfw will not be altered or removed.  Under Microsoft
  76.   Windows, sfwjpg.exe must be invoked from the run window
  77.   command line.
  78.  
  79.  
  80. pwpjpg
  81.  
  82.   pwpjpg will take a .pwp file and extract the images in the
  83.   file.  A .pwp file typically contains the scanned images from
  84.   an entire roll of film.  The names of the images are contained
  85.   within the .pwp file.  pwpjpg takes a single argument, the
  86.   name of the .pwp file from which to extract the images:
  87.  
  88.   pwpjpg mypics.pwp
  89.  
  90.   This will extract all of the images contained in mypics.pwp
  91.   and write them in the current directory as .jpg (JFIF) files.
  92.   The file names will correspond to the names of the images
  93.   stored in the .pwp file.  mypics.pwp will not be altered or
  94.   removed.  Under Microsoft Windows, pwpjpg.exe must be invoked
  95.   from the run window command line.
  96.  
  97.  
  98. flipjpeg
  99.  
  100.   flipjpeg will do a lossless vertical inversion of the image in
  101.   a .jpg file.  This is a complicated process which is described
  102.   in details.txt.  flipjpeg was written to run under UNIX, and
  103.   uses standard input and output:
  104.  
  105.   flipjpeg < mypic.jpg > myflippedpic.jpg
  106.  
  107.   This will create the file myflippedpic.jpg, which will contain
  108.   the same image as mypic.jpg, except that the vertical ordering
  109.   of the scan lines will be reversed in myflippedpic.jpg.  This
  110.   flipping can be done by most image processing programs, though
  111.   usually not without some gain in file size and/or loss in
  112.   image quality.
  113.  
  114.  
  115. pwpext
  116.  
  117.   pwpext is a UNIX (Bourne) shell script which extracts and
  118.   flips the images from a .pwp file.  It takes a single
  119.   argument, the name of the .pwp file:
  120.  
  121.   pwpext mypics.pwp
  122.  
  123.   This will extract, flip, and store as .jpg files all of the
  124.   images contained in mypics.pwp.  mypics.pwp will not be
  125.   altered or removed.
  126.  
  127.  *************************************************************************************
  128.  *************************************************************************************
  129.  
  130.  Note:
  131.  
  132.   Due to previous events, this note seems to be necessary.
  133.  
  134.   While I've nothing against ports to other kernels, in my opinion it would
  135.   be quite unfair to remove all references to my own efforts and contributions
  136.   and simply replacing those with others, while also removing all references
  137.   to PPC-Lib/ELF and replacing those with other references and maybe some flames
  138.   or even offenses against the competing kernel and porter - without actually
  139.   rewriting the readme text itself in a major way (for example, if I describe what
  140.   *I* specifically did for the port - and what someone else wouldn't have to do a
  141.   *second* time, of course - and if then that one does not even remove/change *those*
  142.   notes and/or give me credit).
  143.  
  144.   You know - since even developing free software costs some money (especially
  145.   phonecosts), at least give some fame and credits back... ;-)
  146.  
  147.   This leads to the strange situation, that I hereby have to copyright this
  148.   .readme text, to claim its authorship and forbid changes which aren't
  149.   clearly marked as being changes to the original: While quotes may have
  150.   been derived from other parts of the distribution, the whole .readme as
  151.   such now is (C)opyrighted by Andreas R. Kleinert in 1998.
  152.  
  153.   Copyrights to the other files remain as such. Nevertheless I'd ask anyone
  154.   to give me credit for the changes which I did myself and which of
  155.   course have been labeled/marked/documented as such. Even free software
  156.   lives from respecting the intellectual work and property of others. Thank you.
  157.  
  158.  *************************************************************************************
  159.  *************************************************************************************
  160.